<!--
  This file is a part of the open-eBackup project.
  This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
  If a copy of the MPL was not distributed with this file, You can obtain one at
  http://mozilla.org/MPL/2.0/.
  
  Copyright (c) [2024] Huawei Technologies Co.,Ltd.
  
  THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
  EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
  MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
  -->

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en-us" xml:lang="en-us">
 <head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="DC.Type" content="topic">
  <meta name="DC.Title" content="Restoring HDFS Filesets">
  <meta name="product" content="">
  <meta name="DC.Relation" scheme="URI" content="en-us_topic_0000002164814242.html">
  <meta name="prodname" content="">
  <meta name="version" content="">
  <meta name="brand" content="">
  <meta name="DC.Publisher" content="20250306">
  <meta name="prodname" content="csbs">
  <meta name="documenttype" content="usermanual">
  <meta name="DC.Format" content="XHTML">
  <meta name="DC.Identifier" content="EN-US_TOPIC_0000002200055245">
  <meta name="DC.Language" content="en-us">
  <link rel="stylesheet" type="text/css" href="public_sys-resources/commonltr.css">
  <title>Restoring HDFS Filesets</title>
 </head>
 <body style="clear:both; padding-left:10px; padding-top:5px; padding-right:5px; padding-bottom:5px">
  <a name="EN-US_TOPIC_0000002200055245"></a><a name="EN-US_TOPIC_0000002200055245"></a>
  <h1 class="topictitle1">Restoring HDFS Filesets</h1>
  <div>
   <p>This section describes how to restore an HDFS fileset that has been backed up to the original location or a new location.</p>
   <div class="section">
    <h4 class="sectiontitle">Context</h4>
    <p>Backup copies, replication copies, or imported copies can be used for restoration. Restoration to the original location or a new location is supported. Replication copies cannot be used for restoration to the original location.</p>
   </div>
   <div class="section" id="EN-US_TOPIC_0000002200055245__section5561113335717">
    <h4 class="sectiontitle">Prerequisites</h4>
    <ul id="EN-US_TOPIC_0000002200055245__ul29502613113">
     <li id="EN-US_TOPIC_0000002200055245__li795172610111">If you need to restore ACL information of HDFS files, ensure that the HDFS ACL configuration has been enabled on the big data platform before the restoration. For details, see <a href="en-us_topic_0000002164654490.html">Step 2: Checking the HDFS ACL Switch Status</a>.</li>
     <li id="EN-US_TOPIC_0000002200055245__li562133216110">If you need to restore ACL information of HDFS files, you must have HDFS super user permissions. The user is configured in <a href="en-us_topic_0000002200140845.html">Step 3: Registering an HDFS Cluster</a>.</li>
    </ul>
   </div>
   <div class="section">
    <h4 class="sectiontitle">Procedure</h4>
    <ol>
     <li><span>Choose <span class="uicontrol" id="EN-US_TOPIC_0000002200055245__en-us_topic_0000002164654518_en-us_topic_0000002199964685_uicontrol317519513496"><b><span id="EN-US_TOPIC_0000002200055245__en-us_topic_0000002164654518_en-us_topic_0000002199964685_text16175459497"><strong>Explore</strong></span> &gt; <span id="EN-US_TOPIC_0000002200055245__en-us_topic_0000002164654518_en-us_topic_0000002199964685_text1017555104914"><strong>Copy Data</strong></span> &gt; <span id="EN-US_TOPIC_0000002200055245__en-us_topic_0000002164654518_en-us_topic_0000002199964685_text1483910189532"><strong>Big Data</strong></span> &gt; HDFS</b></span>.</span></li>
     <li><span>You can search for copies by HDFS fileset resource or copy. This section describes how to search for copies by resource.</span><p></p><p>On the <strong>Resources</strong> tab page, locate the fileset to be restored based on the fileset name and click the fileset name.</p> <p></p></li>
     <li><span>Click <span class="uicontrol"><b><span><strong>Copy Data</strong></span></b></span> and select the year, month, and day in sequence to locate the copy.</span><p></p><p>If <span><img src="en-us_image_0000002164654586.png"></span> is displayed below a month or day, a copy is generated in that month or day.</p> <p></p></li>
     <li><span>In the row of the target copy, choose <span class="uicontrol"><b><span><strong>More</strong></span> &gt; <span><strong>Restore</strong></span></b></span>.</span><p></p><p><a href="#EN-US_TOPIC_0000002200055245__table93951625101715">Table 1</a> describes the related parameters.</p>
      <div class="tablenoborder">
       <a name="EN-US_TOPIC_0000002200055245__table93951625101715"></a><a name="table93951625101715"></a>
       <table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000002200055245__table93951625101715" frame="border" border="1" rules="all">
        <caption>
         <b>Table 1 </b>Fileset restoration parameters
        </caption>
        <colgroup>
         <col style="width:23.09%">
         <col style="width:76.91%">
        </colgroup>
        <thead align="left">
         <tr>
          <th align="left" class="cellrowborder" valign="top" width="23.09%" id="mcps1.3.4.2.4.2.2.2.3.1.1"><p>Parameter</p></th>
          <th align="left" class="cellrowborder" valign="top" width="76.91%" id="mcps1.3.4.2.4.2.2.2.3.1.2"><p>Description</p></th>
         </tr>
        </thead>
        <tbody>
         <tr>
          <td class="cellrowborder" valign="top" width="23.09%" headers="mcps1.3.4.2.4.2.2.2.3.1.1 "><p><span><strong>Restore To</strong></span></p></td>
          <td class="cellrowborder" valign="top" width="76.91%" headers="mcps1.3.4.2.4.2.2.2.3.1.2 "><p>The location to which the fileset is restored.</p>
           <ul>
            <li><span><strong>Original location</strong></span>: Restore the fileset to the original HDFS cluster.</li>
            <li><span><strong>New location</strong></span>: Restore the fileset to a new location. You must specify the target HDFS cluster and path.</li>
           </ul></td>
         </tr>
         <tr>
          <td class="cellrowborder" valign="top" width="23.09%" headers="mcps1.3.4.2.4.2.2.2.3.1.1 "><p><span><strong>Target Cluster</strong></span></p></td>
          <td class="cellrowborder" valign="top" width="76.91%" headers="mcps1.3.4.2.4.2.2.2.3.1.2 "><p>When the fileset is restored to a new location, you must specify the target HDFS cluster, which can be the original cluster or another cluster added to the management page.</p></td>
         </tr>
         <tr>
          <td class="cellrowborder" valign="top" width="23.09%" headers="mcps1.3.4.2.4.2.2.2.3.1.1 "><p><span><strong>Path</strong></span></p></td>
          <td class="cellrowborder" valign="top" width="76.91%" headers="mcps1.3.4.2.4.2.2.2.3.1.2 "><p>When the fileset is restored to a new location, you must specify the path for the restoration.</p></td>
         </tr>
         <tr>
          <td class="cellrowborder" valign="top" width="23.09%" headers="mcps1.3.4.2.4.2.2.2.3.1.1 "><p><span><strong>Please select</strong></span></p></td>
          <td class="cellrowborder" valign="top" width="76.91%" headers="mcps1.3.4.2.4.2.2.2.3.1.2 "><p>If files with the same names exist in the restoration path, you can select either of the following:</p>
           <ul>
            <li><span><strong>Skip existing files</strong></span>: Files with the same names are skipped and are not replaced.</li>
            <li><span><strong>Replace existing files</strong></span></li>
           </ul></td>
         </tr>
         <tr>
          <td class="cellrowborder" valign="top" width="23.09%" headers="mcps1.3.4.2.4.2.2.2.3.1.1 "><p><strong id="EN-US_TOPIC_0000002200055245__en-us_topic_0000002200055221_b1684105921110">Remaining Capacity Threshold of Production Storage</strong></p>
           <div class="note">
            <span class="notetitle"> NOTE: </span>
            <div class="notebody">
             <p id="EN-US_TOPIC_0000002200055245__en-us_topic_0000002200055221_p36661248295">This parameter is available only in 1.6.RC2 and later versions.</p>
            </div>
           </div></td>
          <td class="cellrowborder" valign="top" width="76.91%" headers="mcps1.3.4.2.4.2.2.2.3.1.2 "><p>During backup or restoration, the Hadoop snapshot technology occupies production storage space, and you need to properly configure this parameter. If the percentage of the remaining capacity of the production storage is less than the threshold, backup or restoration jobs cannot be triggered.</p></td>
         </tr>
        </tbody>
       </table>
      </div> <p></p></li>
     <li><span>Click <span class="uicontrol"><b>OK</b></span>.</span></li>
    </ol>
   </div>
  </div>
  <div>
   <div class="familylinks">
    <div class="parentlink">
     <strong>Parent topic:</strong> <a href="en-us_topic_0000002164814242.html">Restoration</a>
    </div>
   </div>
  </div>
 </body>
</html>